home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 November / macformat-043.iso / mac / Shareware Plus / Developers / OpenStack Rinaldi Collection / openstack-rinaldi-lib / MergeItems 1.0 (US) / MergeItems 1.0 (US).rsrc / HELP_5635 next >
Encoding:
Text File  |  1996-01-09  |  2.6 KB  |  58 lines
  1.  
  2.  
  3.                                             MergeItems 1.0
  4.  
  5.                                            by Frédéric RINALDI
  6.  
  7.  
  8. DESCRIPTION
  9.   MergeItems allows to merge items of two text lists.
  10.  
  11. SYNTAX
  12.             MergeItems(<new list>,<target list>[,«start[,stop]»]
  13.                               [,«replace»][,«i=sep»][,«l=sep»][,«"useEmpty"»])
  14.  
  15. PARAMETERS
  16.    «» params are order-independant.
  17.  
  18.    <new list> is the text list to add.
  19.  
  20.    <target list> is the target text list.
  21.  
  22.    «start[,stop]» is a one or two items param, defining the starting item to insert before or to replace, and the optional ending item. Default is insertion after last item.
  23.  
  24.    «replace» is a boolean defining if merging will insert (false) or replace (true) the target item(s). This param is handled only if <start[,stop]> param is defined. Default is false (insertion).
  25.  
  26.    «i=sep» defines the item separator. sep can be any character, or the valid constants space, return, tab or quote. Default is comma. Current ItemDelimiter property value is equivalent.
  27.  
  28.    «l=sep» defines the line separator. sep can be any character, or the valid constants space, return, tab or quote. Default is return. This powerful feature allows, in conjunction with «i=sep» param, to handle any type of list.
  29.  
  30.    «"useEmpty"» is a litteral, and changes the behaviour of the XFCN. By default, any empty item in the new list is ignored, but whith "useEmpty", the empty items are handled and inserted or replaced in the destination list.
  31.  
  32.    Using "!", "?" and "=" as first parameter will return an online help (resp. copyright,  syntax and output).
  33.  
  34. USING
  35.    The XFCN returns the merged list.
  36.  
  37. ERRORS
  38. If an error occurs, MergeItems can return :
  39.      "Error : Out of memory"
  40.      "Error : Missing parameter(s)"
  41.      "Error : Bad separator param"
  42.      "Error : Incorrect start item"
  43.      "Error : Stop item must be greater that start item"
  44.      "Error : Incorrect stop item"
  45.  
  46.  
  47. HISTORY
  48. 1.0                                                                  07/12/93
  49. • First public release
  50. --------------------------------------------------------------------
  51.    All externals included in this stack are FreeWare and may be used in non-commercial software provided the following notice is visibly present :
  52.  
  53.                    MergeItems XCMD © Frederic Rinaldi, 1989…1993.
  54.  
  55.    Free for non-commercial use. Use in commercial software subjected to prior acknowledgement and licensing from the author, reachable at the following network addresses:
  56.  
  57. AppleLink: RINALDI1   CalvaCom : FR10    Compuserve : 71170,2111
  58.                Internet : RINALDI1@APPLELINK.APPLE.COM